home *** CD-ROM | disk | FTP | other *** search
/ Aminet 31 / Aminet 31 (1999)(Schatztruhe)[!][Jun 1999].iso / Aminet / comm / news / slrn-bin.lha / slrn / doc / SCORE_FAQ < prev    next >
Text File  |  1999-04-27  |  9KB  |  270 lines
  1. -*- text -*-
  2. The purpose of this FAQ is to provide answers for commonly asked questions
  3. about slrn score files.  Some of the questions are based on a similar FAQ
  4. for the rn newsreader.
  5.  
  6. Questions:
  7.  
  8. 1. How do I set up slrn to read a score file?
  9. 2. What is the format of an slrn score file?
  10. 3. How do I assign a score to a specific subject, e.g., ``test'' messages?
  11. 4. How do I score postings from a specific person?
  12. 5. How do I score articles from a specific site?
  13. 6. How do I score followups?
  14. 7. How do I kill cross posts from a specific group?
  15. 8. How do I score all cross-posts?
  16. 9. I know how to kill posts from a specific person. How do I make it so I
  17.     read _only_ the posts from a specific person?
  18. 10. How do I score articles that have no references line but whose subject
  19.         line starts with ``Re:''
  20. 11. How do I score subject headers that contain only uppercase characters?
  21.  
  22. Answers:
  23.  
  24. ------------------------------
  25.  
  26. Subject: 1. How do I set up slrn to read a score file?
  27.  
  28.     In order for slrn to read a score file, it must know the name of the
  29.     score file.  This is specified by putting the appropriate line in your
  30.     .slrnrc file.  For example, if the name of the score file is `Score' and
  31.     it is located in the News subdirectory, then add the line:
  32.  
  33.         scorefile "News/Score"
  34.  
  35.     to your .slrnrc file.
  36.  
  37. ------------------------------
  38.  
  39. Subject: 2. What is the format of an slrn score file?
  40.  
  41.     The format is simple.  It consists sections that scores that are to be
  42.     applied to one or more newsgroups.  Each section must start with a line
  43.     that contains the name of the newsgroup, enclosed in square brackets,
  44.     for which the scores defined by that section apply.
  45.  
  46.     For example, a line of the form:
  47.  
  48.         [sci.physics.*]
  49.  
  50.     indicates the beginning of a section of scores for the sci.physics
  51.     hierarchy of newsgroups.
  52.  
  53.     Individual scores of a section start with the `Score' keyword.  It
  54.     indicates how many points are to be awarded to the article if it passes
  55.     the test defined by the score.  For example,
  56.  
  57.        Score: 100
  58.          Subject: neutrino
  59.  
  60.     defines a score of 100 points to an article if the subject contains the
  61.     word `neutrino'.
  62.  
  63.     It is also possible to score an article based on more than one header.
  64.     For example,
  65.  
  66.        Score: 1000
  67.          Subject: path integral
  68.      From: Richard Feynman
  69.  
  70.     gives an article a score of 1000 if the subject is about path integrals
  71.     and the author is ``Richard Feynman''.
  72.  
  73.     A score of -9999 is a special score.  If an article scores this value on
  74.     a given test, any other tests for the article will be skipped and the
  75.     article will be killed.
  76.  
  77.     If the first character of a score is `=', the article will given the
  78.     score and the rest of the tests will be skipped.  For example,
  79.  
  80.        [sci.physics.*]
  81.  
  82.        Score: =1000
  83.          From: @space.mit.edu
  84.  
  85.        Score: -9999
  86.          Xref: astrology
  87.  
  88.     defines two tests for the sci.physics hierarchy of newsgroups.  Since
  89.     the first score starts with the `=' character, any article that whose
  90.     author's email address contains `space.mit.edu' will be given 1000
  91.     points and the rest of the tests will be skipped.  The second test
  92.     assigns a score of -9999 to any article cross posted to an astrology
  93.     newsgroup.  Since the score defined by this test is -9999, the article
  94.     will be killed.  Together these two tests indicate that any article
  95.     cross posted to an astrology newsgroup is killed except if the author is
  96.     from space.mit.edu in which case the article is awarded 1000 points.
  97.  
  98.     The `~' character may used used as a NOT operator.  For example, the
  99.     previous score can (almost) be written:
  100.  
  101.       [sci.physics.*]
  102.  
  103.       Score: -9999
  104.        ~From: @space.mit.edu
  105.         Xref: astrology
  106.  
  107.     This simply says to kill any article that was cross posted to an
  108.     astrology group UNLESS the author is from space.mit.edu.
  109.  
  110.     Finally the ``Score'' keyword can be followed by 2 colons to indicate
  111.     that any the score is awarded to the article if any of the tests defined
  112.     by the score are passed.  For example,
  113.  
  114.        Score:: 1000
  115.          Subject: neutrino
  116.      Subject: fermion
  117.  
  118.     assigns a score of 1000 to an article if its subject line contains
  119.     either neutrino or fermion.
  120.  
  121. ------------------------------
  122.  
  123. Subject: 3. How do I assign a score to a specific subject, e.g., ``test'' messages?
  124.  
  125.      Score: -9999
  126.      Subject: test
  127.  
  128. ------------------------------
  129.  
  130. Subject: 4. How do I score postings from a specific person?
  131.  
  132.      Score: -9999
  133.      From: name@who\.knows\.where
  134.  
  135.    assigns a score of -9999 to the person name@who.knows.where.
  136.  
  137. ------------------------------
  138.  
  139. Subject: 5. How do I score articles from a specific site?
  140.  
  141.      Score: -9999
  142.      From: @who\.knows\.where
  143.  
  144.    will give a score of -9999 to an From line that contains
  145.    `@who.knows.where'.
  146.  
  147. ------------------------------
  148.  
  149. Subject: 6. How do I score followups?
  150.  
  151.    Assume a followup either contains a subject starting with `Re:' or has a
  152.    references header.  To assign a score of -9999 to such an article use:
  153.  
  154.       Score:: -9999
  155.       Subject: ^Re:
  156.       References: .
  157.  
  158.    Note the use of the double colon following the score keyword.  This
  159.    indicates that the score is an OR type expression.  This means that the
  160.    above score will pick out articles with EITHER subjects that begin with
  161.    `Re:' OR have a references line.
  162.  
  163.    To score articles with BOTH subjects with `Re:' AND a references headers,
  164.    use the single colon form:
  165.  
  166.       Score: -9999
  167.       Subject: ^Re:
  168.       References: .
  169.  
  170.    Single colon forms are AND expressions.
  171.  
  172. ------------------------------
  173.  
  174. Subject: 7. How do I kill cross posts from a specific group?
  175.  
  176.    You have two choices: either use the `Xref' header or the `Newsgroups'
  177.    header.   It is best to avoid the `Newsgroups' header if possible, that
  178.    is, try to use the Xref header.
  179.  
  180.    Assume that you want to score any article that was cross-posted to an
  181.    ``astrology'' newsgroup.  Then use one of the following forms:
  182.  
  183.        Score: -9999
  184.        Xref: astrology
  185.  
  186.        Score: -9999
  187.        Newsgroups: astrology
  188.  
  189.    Again, try to avoid using the last form if possible.
  190.  
  191. ------------------------------
  192.  
  193. Subject: 8. How do I score all cross-posts?
  194.  
  195.    Like the previous answer you have two choices: to use the Xref header
  196.    (preferred) or the Newsgroups header.  The first choice uses the fact
  197.    that a cross-posted article will have two colons in the Xref header
  198.    field.  So, use a score of the form:
  199.  
  200.       Score: -9999
  201.       Xref: :.*:
  202.  
  203.    If you do not have the option of using the Xref header, use:
  204.  
  205.      Score: -9999
  206.      Newsgroups: ,
  207.  
  208. ------------------------------
  209.  
  210. Subject: 9. I know how to kill posts from a specific person. How do I make it so I
  211.     read _only_ the posts from a specific person?
  212.  
  213.    The answer is simple: kill posts by everyone else.  Assume that you want
  214.    to only read posts by someone whose from line contains: someone@i.like.
  215.    Then use a score of the form:
  216.  
  217.       Score: -9999
  218.       ~From: someone@i\.like
  219.  
  220.    Note the use of the NOT indicator (~).
  221.  
  222. Subject: 10. How do I score articles that have no references line but whose
  223.          subject line starts with ``Re:''
  224.  
  225.    Define a score based on the references header and the subject headers,
  226.    e.g., 
  227.    
  228.       Score: -9999
  229.       ~References: .
  230.       Subject: ^Re: 
  231.       
  232.    Here the the references line simply says that the article must NOT have a
  233.    references header.  The subject header uses a regular expressions that
  234.    says ``Re:'' must occur at the beginning of the subject.  This will match
  235.    the strings "Re:", "re:", "rE:", and "RE:".  To match only "Re:", use the
  236.    regular expression
  237.    
  238.       Subject: ^\cRe:
  239.       
  240.    Here \c turns on case-sensitivity.  To turn it off, use \C.
  241.    
  242. 11. How do I score subject headers that contain only uppercase characters?
  243.  
  244.    Use something like:
  245.    
  246.       Score: -9999
  247.         ~Subject: \c[a-z]
  248.     
  249.    This will assign a score of -9999 to any article whose subject header
  250.    does NOT contain a lowercase character.  To also kill followups to such
  251.    articles use:
  252.  
  253.       Score: -9999
  254.         Subject: ^Re: